home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / edu / otd_20.zip / OTD.DOC < prev    next >
Text File  |  1994-07-30  |  42KB  |  1,374 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                       The Software Construction Co.
  8.  
  9.                               Presents ...
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                             On This Day (tm)
  21.                                Version 2.0
  22.                                 July 1994
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                             _______
  29.                        ____|__     |               (tm)
  30.                     --|       |    |-------------------
  31.                       |   ____|__  |  Association of
  32.                       |  |       |_|  Shareware
  33.                       |__|   o   |    Professionals
  34.                     -----|   |   | --------------------
  35.                          |___|___|    MEMBER
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                       The Software Construction Co
  42.                                PO Box 160
  43.                      North Billerica, MA  01862-0160
  44.                              (508) 851-6204
  45.                              CIS: 70313,3615
  46.                     Internet: softcons@world.std.com
  47.  
  48.  
  49.  
  50.  
  51.   (C) Copyright 1990-1994 The Software Construction Co., All Rights Reserved.
  52.          1. Introduction                                             1
  53.          2. Command Line                                             2
  54.          3. Databases                                                4
  55.          4. Database format                                          7
  56.          5. Date specifiers                                          8
  57.          6. Notes about calendars                                   10
  58.          7. User Supported Software                                 12
  59.          8. Bug Reports                                             15
  60.          9. Known Problems/Limitations                              16
  61.          Appendices                                                 17
  62.              A. Bibliography                                        17
  63.              B. Program History                                     18
  64.          On This Day                                       Version 2.0
  65.  
  66.          1. Introduction
  67.  
  68.          Have you ever been curious about events that happened on this
  69.          day in history?  On This Day is a collection of databases and
  70.          a printing interface which will generate a list of items of
  71.          note concerning today.  The databases sent to registered
  72.          users contain more than 16,000 entries (see section 7 for
  73.          more information about registration).
  74.  
  75.          Some of the types of information which may be displayed are:
  76.  
  77.                    - Astronomical events.
  78.  
  79.                    - Birthdays of famous people.
  80.  
  81.                    - Historical events.
  82.  
  83.                    - National observations.
  84.  
  85.                    - Religious holidays and events.
  86.  
  87.          In addition, a personal database may be created to contain
  88.          events important to each specific user.  Events such as
  89.          birthdays of relatives and friends may be appropriate for
  90.          this file.
  91.  
  92.          To clarify, the question this software is intending to answer
  93.          is:
  94.  
  95.          What historical events, religious holidays, etc. happened on
  96.          a particular date?
  97.  
  98.          It is not intended to answer questions like:
  99.  
  100.          What date is Easter next year?
  101.          When was John Wayne born?
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.                                        1 
  124.          On This Day                                       Version 2.0
  125.  
  126.          2. Command Line
  127.  
  128.          To run On This Day, use the following command line (note that
  129.          []s enclose optional arguments):
  130.  
  131.                    OTD [-b] [-e] [-p] [-r] [-d <date>]
  132.                        [-m <day-number>|all]
  133.  
  134.                    where:
  135.  
  136.                              b  prints famous birthdays
  137.  
  138.                              d  allows you to specify a date other
  139.                                 than today's date.  Date may be ANY
  140.                                 form specified in section 5, below.
  141.                                 Some may not make sense in actual use
  142.                                 (e.g. R(*) would only print stuff on
  143.                                 Thursdays.)  Note also that only items
  144.                                 that occurred before the date
  145.                                 specified will be printed.
  146.  
  147.                              e  prints today's events
  148.  
  149.                              p  prints today's personal events
  150.  
  151.                              r  prints today's religious events
  152.  
  153.                              m  indicates when to print monthly events
  154.                                 (<day-number> indicates the day each
  155.                                 month.  all indicates to print every
  156.                                 day.) (default: 1)  For example, the
  157.                                 command:  'otd -m 3' will print
  158.                                 today's events and if today is the
  159.                                 third day of the month, it will also
  160.                                 print any existing monthly events. For
  161.                                 more information on monthly events,
  162.                                 see section 5.
  163.  
  164.          Again, we must emphasize that it is NOT necessary to input
  165.          ANY arguments to the OTD command.  Simply typing "OTD"
  166.          (without the quotes, of course) will get you all the output
  167.          in the format that we believe most users want.  If you want
  168.          to alter the output in any way, use the options as described
  169.          above.
  170.  
  171.          Running OTD with none of the b, e, p, or r options is the
  172.          same as running with all the options.  If any of these
  173.          options are specified, only those categories will be
  174.          displayed.
  175.  
  176.          DOS hints:
  177.  
  178.          Q:     How can I print the output of OTD?
  179.  
  180.          A:     Append '> PRN:' to your command line (e.g. OTD > PRN:
  181.                 will send today's information to the printer).
  182.  
  183.                                        2 
  184.          On This Day                                       Version 2.0
  185.  
  186.          Q:     It all goes by so quickly ... How do I get it to slow
  187.                 down so I can read it all?
  188.  
  189.          A:     Append '| MORE' to your command line (e.g. OTD | MORE
  190.                 will run OTD, displaying the results one screen at a
  191.                 time).  For more information on the MORE filter, see
  192.                 your DOS manual.
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.                                        3 
  244.          On This Day                                       Version 2.0
  245.  
  246.          3. Databases
  247.  
  248.          On This Day reads it's data from a subset of the following
  249.          databases:
  250.  
  251.  
  252.                    BIRTHDAY.JAN         EVENTS.JAN
  253.                    BIRTHDAY.FEB         EVENTS.FEB
  254.                    BIRTHDAY.MAR         EVENTS.MAR
  255.                    BIRTHDAY.APR         EVENTS.APR
  256.                    BIRTHDAY.MAY         EVENTS.MAY
  257.                    BIRTHDAY.JUN         EVENTS.JUN
  258.                    BIRTHDAY.JUL         EVENTS.JUL
  259.                    BIRTHDAY.AUG         EVENTS.AUG
  260.                    BIRTHDAY.SEP         EVENTS.SEP
  261.                    BIRTHDAY.OCT         EVENTS.OCT
  262.                    BIRTHDAY.NOV         EVENTS.NOV
  263.                    BIRTHDAY.DEC         EVENTS.DEC
  264.                    RELIGION             EVENTS.OTH
  265.                    PERSONAL
  266.  
  267.          Files in the current directory by these names will be used
  268.          first.  If they do not exist there, the environment variable
  269.          OTDDIR will be searched.  It has the same syntax as the PATH
  270.          environment variable.  That is, you could place all the
  271.          BIRTHDAY databases in one subdirectory and all EVENTS
  272.          databases in another specifying all these subdirectories in
  273.          the OTDDIR environment variable.  For example:
  274.  
  275.          SET OTDDIR=C:\OTD\BDAY;C:\OTD\EVT
  276.  
  277.          Or, you might want to place some of the databases on a disk
  278.          in each of two floppy drives on a floppy-only system.  In
  279.          this case, you might want to use the following setting to
  280.          enable OTD to search both places for data:
  281.  
  282.          SET OTDDIR=A:\;B:\
  283.  
  284.          Typically, however, this facility will be used so that the
  285.          OTD command may be invoked from anywhere on your disk and it
  286.          will find the appropriate data files in one directory.  For
  287.          example:
  288.  
  289.          SET OTDDIR=C:\OTD
  290.  
  291.          If the -d option has not been specified, the current date
  292.          from the system clock is used it to determine the extension
  293.          to use in the BIRTHDAY and EVENTS files.
  294.  
  295.          If you set the TZ environment variable, OTD will use that
  296.          value when printing times for astronomical events.  The
  297.          syntax of the TZ environment variable is:
  298.  
  299.          SET TZ=zzz[+/-]d[d][lll]
  300.  
  301.  
  302.  
  303.                                        4 
  304.          On This Day                                       Version 2.0
  305.  
  306.          zzz is a three character field representing the name of the
  307.          current time zone (e.g. EST, PST).
  308.  
  309.          [+/-]d[d] is an optionally signed number of one or more
  310.          digits.  It is the local time zone's difference from GMT in
  311.          hours.  Negative numbers adjust westward from GMT. (e.g.
  312.          5=EST, +8=PST, and -1=continental Europe).
  313.  
  314.          lll is an optional three-character field that represents the
  315.          local time zone daylight savings time (e.g. EDT, PDT).  Don't
  316.          include this field if your time zone does not have daylight
  317.          savings time.
  318.  
  319.          If the TZ environment variable isn't present or is not of the
  320.          above form, a default value of EST5EDT will be used.
  321.  
  322.          If birthday information was requested, BIRTHDAY.<mon> will be
  323.          read.  If events were requested, EVENTS.<mon> and EVENTS.OTH
  324.          will be read.  EVENTS.OTH is used for those events which
  325.          might be in different months in different years.  If
  326.          religious events were requested, RELIGION will be read.  If
  327.          personal events were requested, PERSONAL will be read.
  328.  
  329.          The entries will be printed as they are encountered in each
  330.          database.  If you want entries printed in a specific order,
  331.          they must be in that order in the database.
  332.  
  333.          OTD is distributed with all the above databases with the
  334.          exception of PERSONAL.  Note, however, that much larger and
  335.          more extensive databases will be sent to you should you
  336.          register your copy (see section 7 for more information about
  337.          this and other advantages of registration).
  338.  
  339.          Some of the databases distributed with the program are
  340.          compressed.  This helps save disk space upon installation.
  341.          OTD determines dynamically whether a database is compressed
  342.          or not and reads it appropriately.  Upon registration, you
  343.          will also receive the compression and decompression programs
  344.          so that you may maintain the databases that we distribute.
  345.  
  346.          You may, of course, replace any of our compressed databases
  347.          with your own in order to try out some of the features of the
  348.          event specification language.  Or, you may try out
  349.          interesting features in your PERSONAL database without
  350.          touching any of our databases.  The program itself is not
  351.          crippled in any way.  You have the ability to test all
  352.          functionality it is capable of performing.
  353.  
  354.          Note that the information contained in the databases
  355.          distributed with the program has been taken from a great many
  356.          sources since sometime in 1985 or so.  We do not guarantee
  357.          their accuracy.  You may also find duplicate entries which
  358.          are not indicated in the database.  We would appreciate
  359.          hearing about these as we do try to weed out the duplicates
  360.          when and if we can find another source to collaborate one of
  361.          the dates.
  362.  
  363.                                        5 
  364.          On This Day                                       Version 2.0
  365.  
  366.          We are always interested in new dates.  If possible, please
  367.          try to give us supporting evidence of a new date.  We do not
  368.          want the databases to get any less reliable than they already
  369.          are.  In fact we want them to improve in reliability over
  370.          time.  We do, however, reserve the right not to add any date
  371.          to the database.
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.                                        6 
  424.          On This Day                                       Version 2.0
  425.  
  426.          4. Database format
  427.  
  428.          A line in the database file may be in one of the following
  429.          forms:
  430.  
  431.                    #:<stuff>
  432.  
  433.                         This line is ignored by OTD.  It is merely
  434.                         used to add commentary to the file.
  435.  
  436.                    <relative date specifier>:<stuff>
  437.  
  438.                         Should today match the relative date
  439.                         specifier, print the stuff to the standard
  440.                         output device.  See section 5 for more
  441.                         detailed information about date specifiers.
  442.  
  443.                    <blanks>:<stuff>
  444.  
  445.                         This type of line indicates a continuation of
  446.                         the line preceding for use when one line won't
  447.                         hold enough text.
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.                                        7 
  484.          On This Day                                       Version 2.0
  485.  
  486.          5. Date specifiers
  487.  
  488.          Date specifiers may have one of the following forms:
  489.  
  490.          Absolute Dates -
  491.  
  492.                    <month-number>
  493.  
  494.                         If this month (in the specified calendar)
  495.                         matches <month-number> and the -m option
  496.                         specifies today as the print day, print the
  497.                         item.
  498.  
  499.                    <month-number>/<day>
  500.  
  501.                         If this month (in the specified calendar)
  502.                         matches <month-number> and this day matches
  503.                         <day>, print the item.
  504.  
  505.                    <month-number>/<day>/<year>
  506.  
  507.                         If this month (in the specified calendar)
  508.                         matches <month-number> and this day matches
  509.                         <day>, print the item with "In <year>,"
  510.                         prepended.
  511.  
  512.          Relative dates -
  513.  
  514.                    <alternate calendar><absolute date>
  515.  
  516.                         This form directs OTD to use the specified
  517.                         calendar to evaluate <absolute date>.  Valid
  518.                         <alternate calendar>s are:
  519.  
  520.                              G or <none> Gregorian
  521.                              H           Hebrew
  522.                              HF          Hebrew Fast Day
  523.                                          (will be moved to following
  524.                                           day if it is Saturday)
  525.                              I           Islamic
  526.                              J           Julian
  527.  
  528.                         See section 6 for short descriptions of these
  529.                         calendars.
  530.  
  531.                    <absolute date>+<days>
  532.  
  533.                         Add <days> to the date specified in <absolute
  534.                         date>.  For example, 1/3+37 is the same as
  535.                         2/9.
  536.  
  537.                    <absolute date>-<days>
  538.  
  539.                         Subtract <days> from the date specified in
  540.                         <absolute date>.  For example, 1/3-21 is the
  541.                         same as 12/13.
  542.  
  543.                                        8 
  544.          On This Day                                       Version 2.0
  545.  
  546.                    <wkday>(<month>/<day>)
  547.  
  548.                         This specifies the first <wkday> occurring on
  549.                         or before the date specified by <month> and
  550.                         <day>.  Valid values for <wkday> are:
  551.  
  552.                              M          Monday
  553.                              T          Tuesday
  554.                              W          Wednesday
  555.                              R          thuRsday
  556.                              F          Friday
  557.                              S          Saturday
  558.                              U          sUnday
  559.  
  560.                         For example, W(8/14) specifies the second
  561.                         Wednesday occurring in the month of August.
  562.  
  563.                    <wkday>(*)
  564.  
  565.                         This denotes every day that happens to fall on
  566.                         the specified <wkday>.  Valid values for
  567.                         <wkday> are:
  568.  
  569.                              M          Monday
  570.                              T          Tuesday
  571.                              W          Wednesday
  572.                              R          thuRsday
  573.                              F          Friday
  574.                              S          Saturday
  575.                              U          sUnday
  576.  
  577.                         For example, M(*) specifies every Monday.
  578.  
  579.                    E
  580.  
  581.                         This denotes the Christian holiday Easter.
  582.  
  583.                    E+<days>
  584.  
  585.                         This denotes a date <days> days following the
  586.                         Christian holiday Easter.  This format is
  587.                         necessary to specify all the Christian
  588.                         holidays as many are based upon Easter's date.
  589.  
  590.                    E-<days>
  591.  
  592.                         This denotes a date <days> days before the
  593.                         Christian holiday Easter.  This format is
  594.                         necessary to specify all the Christian
  595.                         holidays as many are based upon Easter's date.
  596.  
  597.                    *
  598.  
  599.                         This denotes every day.
  600.  
  601.  
  602.  
  603.                                        9 
  604.          On This Day                                       Version 2.0
  605.  
  606.          6. Notes about calendars
  607.  
  608.          Gregorian calendar
  609.  
  610.                 This calendar is the one in use currently by much of
  611.                 the world (including the United States).  It was
  612.                 designed by a commission assembled by Pope Gregory
  613.                 XIII in the sixteenth century.  It is based on the
  614.                 revolution of the earth about the sun.
  615.  
  616.                 The months and corresponding numbers that are legal
  617.                 for this calendar are:
  618.  
  619.                 January         1
  620.                 February        2
  621.                 March           3
  622.                 April           4
  623.                 May             5
  624.                 June            6
  625.                 July            7
  626.                 August          8
  627.                 September       9
  628.                 October         10
  629.                 November        11
  630.                 December        12
  631.  
  632.          Hebrew calendar
  633.  
  634.                 This calendar was placed in operation in the mid-
  635.                 fourth century by Hillel II.  It is based on the
  636.                 moon's revolution about the earth.  However, it has
  637.                 solar corrections built in.
  638.  
  639.                 The months and corresponding numbers that are legal
  640.                 for this calendar are:
  641.  
  642.                 Nisan   1
  643.                 Iyyar   2
  644.                 Sivan   3
  645.                 Tammuz  4
  646.                 Av      5
  647.                 Elul    6
  648.                 Tishri  7
  649.                 Heshvan 8
  650.                 Kislev  9
  651.                 Teveth  10
  652.                 Shevat  11
  653.                 Adar    12
  654.                 Adar II 13 {Note Adar is Adar I in years when
  655.                             there is an Adar II}
  656.  
  657.                 Certain holidays (fast days) must be moved to the
  658.                 following day (Sunday) if they fall on a Saturday.
  659.                 The HF calendar specifier allows you to indicate a
  660.                 Hebrew date is one of these "special" holidays.
  661.  
  662.  
  663.                                       10 
  664.          On This Day                                       Version 2.0
  665.  
  666.                 Note that one holiday (Ta'anit Esther) occurs on the
  667.                 preceding Thursday when Purim is on a Sunday.  There
  668.                 is no way, currently, to specify this relationship.
  669.  
  670.          Islamic calendar
  671.  
  672.                 This calendar is based upon the moon revolving around
  673.                 the earth.  There are no dates in this calendar before
  674.                 Friday, July 16, 622 (Julian)
  675.  
  676.                 Much of the Islamic world does not agree with
  677.                 calculations to determine this calendar at all.  They
  678.                 only rely on proclamation of the new moon by the
  679.                 authorities at al-Azhar in Cairo to define the
  680.                 calendar.  Consequently, the dates computed here may
  681.                 differ by a day or two from those observed by much of
  682.                 the Islamic population of the world.
  683.  
  684.                 The months and corresponding numbers that are legal
  685.                 for this calendar are:
  686.  
  687.                 Muharram        1
  688.                 Safar           2
  689.                 Rabi I          3
  690.                 Rabi II         4
  691.                 Jumada I        5
  692.                 Jumada II       6
  693.                 Rajab           7
  694.                 Sha'ban         8
  695.                 Ramadan         9
  696.                 Shawwal         10
  697.                 Dhu al-Qada     11
  698.                 Dhu al-Hijjah   12
  699.  
  700.          Julian calendar
  701.  
  702.                 This calendar was instituted in 45 BC by Julius
  703.                 Caesar.  It, too, is based on the revolution of the
  704.                 earth about the sun.
  705.  
  706.                 The months for the Julian calendar are the same as
  707.                 those used for the Gregorian calendar.  See above for
  708.                 more information on the proper month numbers to use
  709.                 when constructing dates.
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.                                       11 
  724.          On This Day                                       Version 2.0
  725.  
  726.          7. User Supported Software
  727.  
  728.          This program is produced by a member of the Association of
  729.          Shareware Professionals (ASP).  ASP wants to make sure that
  730.          the shareware principle works for you.  If you are unable to
  731.          resolve a shareware-related problem with an ASP member by
  732.          contacting the member directly, ASP may be able to help.  The
  733.          ASP Ombudsman can help you resolve a dispute or problem with
  734.          an ASP member, but does not provide technical support for
  735.          members' products.  Please write to the ASP Ombudsman at 545
  736.          Grover Road, Muskegon, MI  49442 or send a CompuServe message
  737.          via CompuServe Mail to ASP Ombudsman 70007,3536.
  738.  
  739.          DEFINITION OF SHAREWARE
  740.  
  741.          Shareware distribution gives users a chance to try software
  742.          before buying it.  If you try a Shareware program and
  743.          continue using it, you are expected to register.  Individual
  744.          programs differ on details -- some request registration while
  745.          others require it, some specify a maximum trial period.  With
  746.          registration, you get anything from the simple right to
  747.          continue using the software to an updated program with
  748.          printed manual.
  749.  
  750.          Copyright laws apply to both Shareware and commercial
  751.          software, and the copyright holder retains all rights, with a
  752.          few specific exceptions as stated below.  Shareware authors
  753.          are accomplished programmers, just like commercial authors,
  754.          and the programs are of comparable quality.  (In both cases,
  755.          there are good programs and bad ones!)  The main difference
  756.          is in the method of distribution.  The author specifically
  757.          grants the right to copy and distribute the software, either
  758.          to all and sundry or to a specific group.  For example, some
  759.          authors require written permission before a commercial disk
  760.          vendor may copy their Shareware.
  761.  
  762.          Shareware is a distribution method, not a type of software.
  763.          You should find software that suits your needs and
  764.          pocketbook, whether it's commercial or Shareware.  The
  765.          Shareware system makes fitting your needs easier, because you
  766.          can try before you buy.  And because the overhead is low,
  767.          prices are low also.  Shareware has the ultimate money-back
  768.          guarantee -- if you don't use the product, you don't pay for
  769.          it.
  770.  
  771.          DISCLAIMER - AGREEMENT
  772.  
  773.          Users of On This Day must accept this disclaimer of warranty:
  774.          "On This Day is supplied as is.  The author disclaims all
  775.          warranties, expressed or implied, including, without
  776.          limitation, the warranties of merchantability and of fitness
  777.          for any purpose.  The author assumes no liability for
  778.          damages, direct or consequential, which may result from the
  779.          use of On This Day."
  780.  
  781.  
  782.  
  783.                                       12 
  784.          On This Day                                       Version 2.0
  785.  
  786.          On This Day is a "shareware program" and is provided at no
  787.          charge to the user for evaluation.  Feel free to share it
  788.          with your friends, but please do not give it away altered or
  789.          as part of another system.  The essence of "user-supported"
  790.          software is to provide personal computer users with quality
  791.          software without high prices, and yet to provide incentive
  792.          for programmers to continue to develop new products.  If you
  793.          find this program useful and find that you are using On This
  794.          Day and continue to use On This Day after a reasonable trial
  795.          period, you must make a registration payment of $30.00 (US
  796.          funds) to The Software Construction Co.  The $30.00
  797.          registration fee will license one copy for use on any one
  798.          computer at any one time.  You must treat this software just
  799.          like a book.  An example is that this software may be used by
  800.          any number of people and may be freely moved from one
  801.          computer location to another, so long as there is no
  802.          possibility of it being used at one location while it's being
  803.          used at another.  Just as a book cannot be read by two
  804.          different persons at the same time.
  805.  
  806.          Commercial users of On This Day must register and pay for
  807.          their copies of On This Day within 30 days of first use or
  808.          their license is withdrawn.  Site-License arrangements may be
  809.          made by contacting The Software Construction Co.
  810.  
  811.          Anyone distributing On This Day for any kind of remuneration
  812.          must first contact The Software Construction Co. via one of
  813.          the means below for authorization.  This authorization will
  814.          be automatically granted to distributors recognized by the
  815.          (ASP) as adhering to its guidelines for shareware
  816.          distributors, and such distributors may begin offering On
  817.          This Day immediately (However The Software Construction Co.
  818.          must still be advised so that the distributor can be kept up-
  819.          to-date with the latest version of On This Day.).
  820.  
  821.          You are encouraged to pass a copy of On This Day along to
  822.          your friends for evaluation.  Please encourage them to
  823.          register their copy if they find that they can use it.  All
  824.          registered users will receive a copy of the latest version of
  825.          On This Day.
  826.  
  827.          If you have received this software through one of the so
  828.          called "Shareware Houses" (companies whose business is
  829.          selling disks containing other author's software), please
  830.          note that none of the money you have paid so far has (or
  831.          will) make its way to the author.  You have simply paid for
  832.          the duplication and distribution costs.
  833.  
  834.          Registration benefits include:
  835.  
  836.                    - Notification of any updates.
  837.  
  838.                    - The latest version of the software.
  839.  
  840.  
  841.  
  842.  
  843.                                       13 
  844.          On This Day                                       Version 2.0
  845.  
  846.                    - The very next version of the software.
  847.  
  848.                    - A much more extensive collection of data.
  849.  
  850.                    - The compression and decompression programs.
  851.  
  852.                    - Several other utilities which make the
  853.                      maintenance of the databases much easier.
  854.  
  855.                    - A quotation database and program.
  856.  
  857.          Although we encourage copying and sharing of On This Day to
  858.          distribute our product, we must insist that you NOT share the
  859.          utilities, compression/decompression programs, and larger
  860.          databases you will receive upon registration.  We retain full
  861.          copyrights to these files.  It is an infringement of
  862.          copyright law to distribute copies of these files.
  863.  
  864.          To make it easier for registered users to share copies of On
  865.          This Day with their friends we have included a utility
  866.          (OTDSHARE.BAT) on the registered version of the disk.  This
  867.          utility will create a "shareable" disk.  Please see the
  868.          read.me file on your registered disk for more information.
  869.  
  870.          Please contact us at:
  871.  
  872.                           The Software Construction Co.
  873.                                  P.O. Box 160
  874.                            North Billerica, MA   01862
  875.  
  876.          Or, you may send a message via CompuServe Mail: 70313,3615
  877.  
  878.          Or, you may send a message via Internet email:
  879.          softcons@world.std.com
  880.  
  881.          Or you may call us at (508) 851-6204.
  882.  
  883.          If you do not use this software, we'd also like to know why.
  884.          It is obvious you're somewhat interested or you wouldn't have
  885.          gotten this far into the manual.  We'd like to know how we
  886.          can make this product better.  Please contact us using the
  887.          same means listed above and let us know what we could have
  888.          done to make them useful to you.
  889.  
  890.          For $5 to cover the cost of the diskette(s) and shipping
  891.          (refunded when you register), we will supply you with the
  892.          latest edition of the software.  Please specify if you'd like
  893.          5.25" or 3.5" diskettes.
  894.  
  895.          We would sincerely like to thank you for giving this, the
  896.          fruits of our labor, a trial.  We hope it proves useful to
  897.          you.
  898.  
  899.  
  900.  
  901.  
  902.  
  903.                                       14 
  904.          On This Day                                       Version 2.0
  905.  
  906.          8. Bug Reports
  907.  
  908.          Should you discover a bug in this code, please let us know
  909.          using one of the mechanisms listed in section 7.  We regret
  910.          that we can't provide phone support at this time (maybe in
  911.          the future).  Provide us with as much of a description of the
  912.          problem as you can, as well as your name and address.  If you
  913.          would prefer being contacted by phone, by all means, add your
  914.          phone number and the hours you will be available at that
  915.          number.
  916.  
  917.          What do you get for your trouble?  We will send a copy of the
  918.          fixed program to the first registered user to report the
  919.          problem and will strive to answer all others with a letter.
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.                                       15 
  964.          On This Day                                       Version 2.0
  965.  
  966.          9. Known Problems/Limitations
  967.  
  968.          a.     The Jewish holiday Ta'anit Esther occurs on the
  969.                 preceding Thursday when Purim falls on Sunday.  There
  970.                 is no way, currently, to indicate this relationship.
  971.                 We are not sure that this functionality will ever be
  972.                 included as this relationship is extraordinarily rare.
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.                                       16 
  1024.          On This Day                                       Version 2.0
  1025.  
  1026.          A. Bibliography
  1027.  
  1028.          Special thanks to John Peyton, a friend who helped get me
  1029.          thinking along the right path several times.
  1030.  
  1031.          Following is a list (no doubt partial) of items I found
  1032.          helpful when learning how to calculate the various calendars,
  1033.          astronomical events, etc. that are contained in the software:
  1034.  
  1035.          Astronomical Formulae for Calculators by Jean Meeus, 1982,
  1036.                 Willmann-Bell, Inc.
  1037.  
  1038.          Calendrical Calculations by Edward M. Reingold and Nachum
  1039.                 Dershowitz, 1989, University of Illinois at Urbana-
  1040.                 Champaign.
  1041.  
  1042.          Practical Astronomy With Your Calculator by Peter Duffett-
  1043.                 Smith, 3rd edition 1988, Cambridge University Press.
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.                                       17 
  1084.          On This Day                                       Version 2.0
  1085.  
  1086.          B. Program History
  1087.  
  1088.          Version 1.0 - April 1990.
  1089.  
  1090.          Version 1.1 - July 1991.
  1091.  
  1092.                 - Phases of the moon added.
  1093.  
  1094.                 - Lunar eclipses added.
  1095.  
  1096.                 - Compression for databases.
  1097.  
  1098.                 - Serial numbers to track distribution better.
  1099.  
  1100.                 - TZ environment variable controls times for
  1101.                   astronomical events.
  1102.  
  1103.                 - A few minor bug fixes.
  1104.  
  1105.                 - CompuServe support offered.
  1106.  
  1107.                 - New installation utility.
  1108.  
  1109.          Version 1.2 - October 1992.
  1110.  
  1111.                 - Registrations accepted by PsL and BUDGETWARE.
  1112.  
  1113.                 - GEnie support offered.
  1114.  
  1115.          Version 1.3 - October 1992.
  1116.  
  1117.                 - Database update.
  1118.  
  1119.          Version 1.4 - January 1993.
  1120.  
  1121.                 - Database update.
  1122.  
  1123.                 - Minor bugfixes.
  1124.  
  1125.                 - Quotation database added as registration incentive.
  1126.  
  1127.  
  1128.          Version 1.5 - May 1993.
  1129.  
  1130.                 - Database update.
  1131.  
  1132.          Version 1.6 - August 1993.
  1133.  
  1134.                 - Database update.
  1135.  
  1136.          Version 1.7 - October 1993.
  1137.  
  1138.                 - Database update.
  1139.  
  1140.  
  1141.  
  1142.  
  1143.                                       18 
  1144.          On This Day                                       Version 2.0
  1145.  
  1146.                 - Weekday printed with Gregorian date.
  1147.  
  1148.                 - dd.mm.yy dateform.
  1149.  
  1150.                 - Easter offset bug (for years other than current)
  1151.                   fixed.
  1152.  
  1153.                 - Continuation lines indented slightly (as in versions
  1154.                   prior to 1.4).
  1155.  
  1156.                 - Day number and number of days remaining printed with
  1157.                   Gregorian calendar.
  1158.  
  1159.  
  1160.          Version 1.8 - January 1994.
  1161.  
  1162.                 - Database update.
  1163.  
  1164.  
  1165.          Version 1.9 - April 1994.
  1166.  
  1167.                 - Database update.
  1168.  
  1169.                 - Problem with installation program not finding AUTOEXEC.BAT
  1170.                   in some rare cases fixed.
  1171.  
  1172.                 - Blank lines in database files are treated as comments.
  1173.  
  1174.                 - Dates before Islamic calendar no longer cause an invalid
  1175.                   date to be displayed.
  1176.  
  1177.          Version 2.0 - July 1994.
  1178.  
  1179.                 - Database update.
  1180.  
  1181.                 - Comments interspersed with continuation lines now
  1182.                   cause the rest of the continuation lines to be
  1183.                   ignored.  This was necessary to support leap years
  1184.                   adequately.
  1185.  
  1186.                 - * now truly means every day, not just today.  That
  1187.                   is, an event tagged * will be displayed every day
  1188.                   not just when displaying the same date as the
  1189.                   system clock.
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.                                       19 
  1204.  
  1205.    - A -
  1206.  
  1207.          absolute dates                 <see dates, absolute>
  1208.          address, CompuServe            14
  1209.          address, Internet              14
  1210.          address, US Mail               14
  1211.          agreement                      12
  1212.          alternate date specification   2
  1213.          ASP Ombudsman                  12
  1214.          Assoc. of Shareware Prof.      12
  1215.          astronomical events            <see events, astronomical>
  1216.  
  1217.    - B -
  1218.  
  1219.          birthdays                      1, 2, 5
  1220.          bugs                           15
  1221.  
  1222.    - C -
  1223.  
  1224.          calendar, Gregorian            8, 10
  1225.          calendar, Hebrew               8, 10
  1226.          calendar, Islamic              8, 11
  1227.          calendar, Julian               8, 11
  1228.          calendars                      10
  1229.          command line                   2
  1230.          command line options           2
  1231.          comments                       7
  1232.          compression                    5
  1233.          continuation lines             7
  1234.  
  1235.    - D -
  1236.  
  1237.          database format                7
  1238.          databases                      4
  1239.          date specifiers                8
  1240.          dates, absolute                8
  1241.          dates, relative                8
  1242.          decompression                  5
  1243.          disclaimer                     12
  1244.  
  1245.    - E -
  1246.  
  1247.          Easter                         9
  1248.          events                         2, 5
  1249.          events, astronomical           1
  1250.          events, historical             1
  1251.          events, monthly                2
  1252.          events, personal               2, 5
  1253.          events, religious              1, 2, 5
  1254.  
  1255.    - G -
  1256.  
  1257.          Gregorian calendar             <see calendar, Gregorian>
  1258.  
  1259.    - H -
  1260.  
  1261.          Hebrew calendar                <see calendar, Hebrew>
  1262.          Hillel II                      10
  1263.          historical events              <see events, historical>
  1264.    - I -
  1265.  
  1266.          introduction                   1
  1267.          Islamic calendar               <see calendar, Islamic>
  1268.  
  1269.    - J -
  1270.  
  1271.          Julian calendar                <see calendar, Julian>
  1272.          Julius Caesar                  11
  1273.  
  1274.    - L -
  1275.  
  1276.          limitations                    16
  1277.  
  1278.    - M -
  1279.  
  1280.          monthly events                 <see events, monthly>
  1281.  
  1282.    - N -
  1283.  
  1284.          national observances           1
  1285.  
  1286.    - O -
  1287.  
  1288.          options, command line          <see command line options>
  1289.          OTDDIR environment variable    4
  1290.  
  1291.    - P -
  1292.  
  1293.          PATH environment variable      4
  1294.          personal events                <see events, personal>
  1295.          phone number                   14
  1296.          Pope Gregory XIII              10
  1297.          problems                       15
  1298.          problems, known                16
  1299.  
  1300.    - R -
  1301.  
  1302.          registration information       5
  1303.          relative dates                 <see dates, relative>
  1304.          religious events               <see events, religious>
  1305.          religious holidays             <see events, religious>
  1306.          reporting bugs                 15
  1307.  
  1308.    - S -
  1309.  
  1310.          shareware                      12
  1311.  
  1312.    - T -
  1313.  
  1314.          time zone                      <see TZ environment variable>
  1315.          TZ environment variable        4
  1316.  
  1317.    - U -
  1318.  
  1319.          user supported software        <see shareware>
  1320.  
  1321.    - Misc -
  1322.  
  1323.          -m option                      8
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.                           The Software Construction Co
  1335.                                    PO Box 160
  1336.                          North Billerica, MA  01862-0160
  1337.                                  (508) 851-6204
  1338.                                  CIS: 70313,3615
  1339.                         Internet: softcons@world.std.com
  1340.  
  1341.         Name:    ________________________________________________________
  1342.  
  1343.         Address: ________________________________________________________
  1344.  
  1345.                  ________________________________________________________
  1346.  
  1347.                  ________________________________________________________
  1348.  
  1349.         Phone:   ________________________________________________________
  1350.  
  1351.         Where did you get your copy of On This Day (version 2.0)?
  1352.  
  1353.         The Software Construction Co. _____        BBS              _____
  1354.  
  1355.         Friend                        _____        Shareware Dealer _____
  1356.  
  1357.         If you checked BBS or Shareware Dealer above please tell us which
  1358.         one:
  1359.  
  1360.         _________________________________________________________________
  1361.  
  1362.         What format media would you like?         5.25" _____  3.5" _____
  1363.  
  1364.         Comments or suggestions: ________________________________________
  1365.  
  1366.         _________________________________________________________________
  1367.  
  1368.         _________________________________________________________________
  1369.  
  1370.         _________________________________________________________________
  1371.  
  1372.         _________________________________________________________________
  1373.  
  1374.